DEVICE RECDATA

0.1 Introduction

The internal RECDATA device is the tool that resides in CPU that allows you to manage data logging type:

To record this data is exploited the RAM of the CPU, for this reason, to use this device, the percentage utilization of data memory (USER Data memory) total shall not exceed 50%. The device occupies the 50% of the RAM.

0.2 Installation

0.2.1 Device declaration in the configuration file (.CNF)

In the configuration file (.CNF), the BUS section must be declared so that you have the hardware resources required for the implementation of the RECDATA device.
In the INTDEVICE section of the .CNF file must be add the following definition:

:info:It is necessary that each definition are present on the same line. In case you do not want to assign a resource, for example IntL, You must enter in the appropriate field the X string.
;---------------------------------
; Internal device declaration
;---------------------------------
INTDEVICE
..
<DEVICE_NAME> RECDATA TCAMP QCTL1 QCTL2 IOUTA1 IOUTA2 INTL1 INTL2 ING1 ING2 OUT1 OUT2

where:

<device name> The name assigned to the device.
RECDATAKeyword that identifies the devices.
TCampTempo di campionamento device (1÷255 ms).
QCTL1Address bi-directional meter 1 (to prevent the device uses this resource to put the X.X character).
QCTL2Address bi-directional meter 2 (to prevent the device uses this resource to put the X.X character).
IOutA1Hardware address of the DAC component of analog output 1. (to prevent the device uses this resource to put the X.X character).
IOutA2Hardware address of the DAC component of analog output 2. (to prevent the device uses this resource to put the X.X character).
IntL1Number of the interrupt line 1 (to prevent the device uses this resource to put the X character). This interrupt line can give the start to registration.
IntL2Number of the interrupt line 2 (to prevent the device uses this resource to put the X character).
Ing1Generic input 1
Ing2Generic input 2
Out1Generic output 1
Out2Generic output 2
;---------------------------------
; Internal device declaration
;---------------------------------
INTDEVICE
Rec  RECDATA  2  2.CNT01  2.CNT02  2.AN01  2.AN02  1  2  2.INP01  2.INP02  2.OUT01  2.OUT02

0.3 Operation

Below is a diagram of the operation of the RECDATA device The RECDATA device works only with the maximum resolution of the transducer (bit encoder * 4). In the case that the analog output declared in the configuration file is used by a device to analog positioning (CAMMING or EANPOS type), the monitor offers the display of the theoretical position of the axis in addition to the practical. The difference between the two counts is the following error of axis. The reference device for this information is the one that currently using the analog output hardware resource.
You can start recording via the interrupt input (IntL1)

0.3.1 Available steps for storing

The device uses 50% of CPU RAM memory, which is split into banks of 16 Bytes. The number of steps available for registration is indicated by stepnum parameter, which is read only, and is calculated with the formula:
stepnum = RAM available : 16
The 16 Bytes of the Bank (named step) are divided into 4 Long, named data1, data2, data3 and data4. Formatting data in memory depends on how you set the mode parameter according to the following order:
State I/O
Encoder 1
Encoder 2
Analog output 1
Analog output 2
Following error 1
Following error 2
Virtual encoder 1
Virtual encoder 2
For the user it will be difficult to interpret the data obtained without going through the QVIEW (the development software has a dedicated tool). For this reason is not delved into the topic if not upon the customer's request.

0.4 Device error management

An error in the device is signaled by the st_error state.
When st_error is equal to 1, are present on the errcode variable the type of error occurred (see table) and in the errvalue variable an indication on the cause of the error

CodePriorityDescription
11Modified mode parameter during registration

If the device goes wrong, in order to start working you have to clear the st_error status through the RSERR command.

0.5 Warning device management

The presence of a warning in the system camming is signaled by the st_warning state.
Being caused by a minor event and being guaranteed in this situation the management of device, the tool continues his work.
When st_warning is equal to 1, are present on the wrncode variable the type of warning intervened (see table) and in the wrnvalue variable an indication as to the cause of the warning.

CodePriorityDescription
10Command not executed

To clear the st_warning state must be send the RSWRN command.

0.6 Commands and parameters table

0.6.1 Symbols used

The parameter name, condition or command is taken back to the left side of the table.

R
Indicates if the parameter or state is retentive (upon initialization of the device maintains the previously defined), or the state assumes upon initialization of the device.
If the device does not need to initialize the “R” field indicates the value that the parameter or state take at the power up of the card.
R = Retentive
0 = Upon initialization of the device the value is forced to zero.
1 = Upon initialization of the device the value is forced to one.
- = Upon initialization of the device is presented significant value.

D
Indicates the size of the parameter.
F = Flag
B = Byte
W = Word
L = Long
S = Single Float

0.6.1.1 Conditions

Describes all the conditions necessary so that the parameter is considered correct or because the command is accepted.
In some cases, limit values are specified for the acceptance of the parameter: if introduced any values outside the limits set, the data is however accepted; therefore appropriate controls of the application must be provided to ensure the proper functioning.
To execute a command, all the conditions must be met; otherwise, the command is not sent.

A
Indicates the access mode.
R = Read.
W = Write.
RW = Read / Write.

0.6.2 Commands

The commands were ranked by decreasing priority. For example, in the case of contemporary of INIT and EMRG commands, is acquired first the INIT command.

NameConditionsDescription
STARTRst_rec = 0
st_error = 0
Start recording
Command the beginning of data acquisition.
Activates the st_reck state.
STOPRst_rec = 1Stop recording
Stops the registration process data.
Reset the st_rec state.
READSTEPstepnum>stepin>1Read step
You can read the step specified in stepin. The data is available when stepin=stepout. It is recommended to read when a recording is in progress (st_rec = 0).
INTENBLcapture>0Interrupt enable
Enable interrupt capture indicated in IntL1 in the configuration file. Upon arrival of the interrupt the devices starts recording that will be stored in delta.
Activates the st_intenbl state.
INTDSBLNoInterrupt disable
Disable the interrupt capture.
Reset the st_intenbl state.
RSCAPTURENoReset capture
Disable the st_capture state.
RSERRNoReset error
Reset the st_error state.
RSWRNNoReset warning
Reset the st_warning state.

0.6.3 Parameters

Name D R A Conditions Description
stepnum L 0 R No Step number
Indicates the maximum number of steps possible to register. The value is automatically fixed when you turn on the system and cannot be changed.
Valid range: 1 ÷ 999999
stepin L 0 R-W No Step input
Indicates the number of steps that the user wants to read with the READSTEP command.
Valid range: 1 ÷ stepnum
stepout L 0 R No Step output
Indicates the number of steps available to read in data1, data2, data3 and data4 parameters.
Valid range: -999999 ÷ 999999
data1 L 0 R No Data number 1
FIXED Variabile d'uso. Al suo interno di trovano i valori catturati durante la registrazione.
Vedi capitolo dediato.
data2 L 0 R No Data number 2
Variabile d'uso. Al suo interno di trovano i valori catturati durante la registrazione.
Vedi capitolo dedicato.
data3 L 0 R No Data number 3
Variabile d'uso. Al suo interno di trovano i valori catturati durante la registrazione.
Vedi capitolo dedicato.
data4 L 0 R No Data number 4
Variabile d'uso. Al suo interno di trovano i valori catturati durante la registrazione.
Vedi capitolo dedicato.
capture B R R-W No Capture mode
Definisce il modo di cattura dell'interrupt sull'impulso di zero.
0=Disabilitato.
1=One-shot su fronte di salita. Viene catturato il primo fronte di salita dell`impulso di zero dopo l`attivazione di st_intenbl.
2=One-shot su fronte di discesa. Viene catturato il primo fronte di discesa dell`impulso di zero dopo l`attivazione di st_intenbl.
Range valido: 0 ÷ 2.
mode B R R-W st_rec = 0 Recording mode
Il modo di registrazione viene definito da un Byte i cui singoli bit, se impostati a 1, abilitano l'acquisizione.
20 = Encoder 1
21 = Encoder 2
22 = Uscita analogica 1
23 = Uscita analogica 2
24 = Errore di inseguimento 1
25 = Errore di inseguimento 2
26 = Encoder virtuale 1
27 = Encoder virtuale 2
Ad esempio, se si vogliono registrare i valori di Encoder 1 e Encoder 2, si imposterà mode = 3
tbase W R R No Time base
Visualizza il tempo di campionamento programmato nel file di configurazione.
errcode B 0 R No Error code
Indica il tipo di errore intervenuto nel sistema. Il codice è valido solo se st_error = 1 (Vedi capitolo dedicato)
Range valido: 0 ÷ 100.
errvalue B 0 R No Error value
Indica la causa dell'errore intervenuto nel sistema. Il codice è valido solo se st_error = 1 (Vedi capitolo dedicato)
Range valido: 0 ÷ 100.
wrncode B 0 R No Warning code
Indica il tipo di warning intervenuto nel sistema. Il codice è valido solo se st_warning = 1 (Vedi capitolo dedicato)
Range valido: 0 ÷ 100.
wrnvalue B 0 R No Warning value
Indica la causa del warning intervenuto nel sistema. Il codice è valido solo se st_warning = 1 (Vedi capitolo dedicato)
Range valido: 0 ÷ 100.

0.6.4 Stati

NomeDRACondizioniDescrizione
st_intenblF0RNessunaInterrupt enabled
Segnala l'abilitazione alla cattura dello lo start alla registrazione da linea di interrupt. Viene attivato dal comando INTENBL e disattivato dal comando INTDSBL o sul fronte di salita di st_capture.
0 = Interrupt disabilitato
1 = Interrupt abilitato.
All'accensione per default viene posto a zero.
st_captureF0RNessunaInterrupt captured
Segnalazione di interrupt catturato; viene resettato con il comando RSCAPTURE.
0 = Interrupt non catturato
1 = Interrupt catturato
All'accensione per default viene posto a zero.
st_int1F0RNessunaStatus of interrupt line 1
Indica lo stato della linea di interrupt IntL1.
0 = Ingresso in interrupt disattivo.
1 = Ingresso in interrupt attivo.
All'accensione per default viene posto a zero.
st_int2F0RNessunaStatus of interrupt line 2
Indica lo stato della linea di interrupt IntL2.
0 = Ingresso in interrupt disattivo.
1 = Ingresso in interrupt attivo.
All'accensione per default viene posto a zero.
st_errorF0RNessunaStatus of device error
Indica lo stato di errore nel device.
Per la decodifica dell'errore si deve fare riferimento alla variabile errcode ed errvalue.
0 = Errore non presente.
1 = Errore presente.
All'accensione per default viene posto a zero.
st_warningF0RNessunaStatus of device warning
Indica lo stato di warning nel device.
Per la decodifica del warning si deve fare riferimento alla variabile wrncode e wrnvalue.
0 = Warning non presente.
1 = Warning presente
All'accensione per default viene posto a zero.

0.7 Limitazioni

Nessuna limitazione